home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / uss1.zip / USS1.DOC < prev    next >
Text File  |  1991-01-20  |  13KB  |  380 lines
  1.                              ╔═╗ ╔═╗ ╔═════╗ ╔═════╗
  2.                              ║ ║ ║ ║ ║ ╔═══╝ ║ ╔═══╝
  3.                              ║ ║ ║ ║ ║ ╚═══╗ ║ ╚═══╗
  4.                              ║ ║ ║ ║ ╚═══╗ ║ ╚═══╗ ║
  5.                              ║ ╚═╝ ║ ╔═══╝ ║ ╔═══╝ ║
  6.                              ╚═════╝ ╚═════╝ ╚═════╝
  7.  
  8.  
  9.                             User Subscription Service
  10.  
  11.                                 By Stephan Howard
  12.  
  13.                              FidoNet Address 1:275/3
  14.  
  15.                           Member of ISS Development Team
  16.  
  17.  
  18.  
  19.      INFORMATION SYSTEMS SOFTWARE
  20.      USS1 Documentation
  21.      Page 2
  22.                               -= DISCLAIMER =-
  23.  
  24.      This program is provided AS IS.
  25.  
  26.      No warranties or guarantees.   The only thing this program is
  27.      guaranteed to do is to take up disk space.  If it fails to work
  28.      with or does bad things to your system (!?) I am Not Responsible.
  29.      I have taken reasonable precautions to insure it is safe BUT,
  30.      your use of this program signifies that you agree to these terms.
  31.  
  32.      Don't try to make money with this thing either.
  33.      Don't sell it.
  34.      Don't charge for its distribution.
  35.      And don't take credit for it!
  36.  
  37.      My terms are simple,  my reasons wise,  so just use the thing
  38.      like it's meant to be!
  39.  
  40.      All  trademarks and registered trademarks belong to their
  41.      respective owners and may be unmarked in this document...
  42.  
  43.      INFORMATION SYSTEMS SOFTWARE
  44.      USS1 Documentation
  45.      Page 3
  46.                                -= REGISTRATION =-
  47.  
  48.      Please help support shareware. By registering this program, you
  49.      are showing that you find this to be a useful addition to your
  50.      BBS. We have a number of shareware utilities available and more
  51.      being developed for Remote Access BBS.  We are also developing
  52.      generic programs for other BBS's also.
  53.  
  54.      It's your support which motivates us to write new and innovative
  55.      programs for you to offer your users.
  56.  
  57.      When you register, you will recieve a key file, which when placed
  58.      in the same directory as USS1 will switch USS1 into registered mode.
  59.  
  60.      Nothing is crippled in this release, and the registered version
  61.      will differ only in that it will inform your users that you have
  62.      a registered copy.
  63.  
  64.      Please support shareware so we will never need to resort to crip-
  65.      pling the software. In our opinion, thats not the answer...
  66.  
  67.      Our prices are low, and our software is not crippled, do your part
  68.      to help keep it this way.
  69.  
  70.      All questions, problems, etc., concerning registrations will be
  71.      handled by Doris Zagorski so...
  72.  
  73.      Registration info may be              Or, if you wish, a postcard:
  74.      NetMailed to: Doris Zagorski
  75.                                            Doris Zagorski  C/O
  76.      FidoNet  - 1:322/235                  Information Systems Software
  77.      RBBS-NET - 8:906/201                  656 Old West Central Street
  78.              or 8:906/1000                 Franklin, Ma.  02038
  79.  
  80.      INFORMATION SYSTEMS SOFTWARE
  81.      USS1 Documentation
  82.      Page 4
  83.                               -= SUPPORT =-
  84.  
  85.           Though I do not anticipate the need for answering questions
  86.      concerning "problems" (there won't be any!! grin!), questions of
  87.      any sort, may be directed to me or a support board per Appendix A.
  88.  
  89.  
  90.      **********************
  91.      * Intro what is USS1 *
  92.      **********************
  93.  
  94.      User Subscription Service (USS) is a Door consisting of Three pro-
  95.      grams.
  96.  
  97.      USS1.EXE is the Door that creates the DataBase of users for BBS's
  98.      that operates under a subscription theme.
  99.  
  100.      The idea is you set it up like a Call Back Verifier,(No its not a
  101.      CBV), so that a NEW user must go enter the Door. After the user
  102.      Completes USS1 the following information is added the DataBase ...
  103.  
  104.       1 : UsersName
  105.       2 : UsesSecurity
  106.       3 : Users RecordNumber from USERS.BBS
  107.       4 : Date the User First Logged on
  108.       5 : Date the User's Account Expires
  109.       6 : Subscription Length
  110.  
  111.      READDAT.EXE is the processer that will then read the DataBase then
  112.      DownGrade the user IF his account is expired.
  113.  
  114.      EDITDAT.EXE will allow you to EDIT/ADD users to the DataBase as
  115.      well as just Browse the Database.
  116.  
  117.      *************************
  118.      *  SetUp and Operation  *
  119.      *************************
  120.  
  121.      USS1.EXE
  122.      ────────
  123.  
  124.      There isn't much to setting up USS1, just unzip to the directory of
  125.      your choice and install USS1 in a menu as a Type 7 or 15 ( Type 7
  126.      is the Prefered)
  127.  
  128.      Create two files DISCLAIM.A?? and REGS.A?? which are two files that
  129.      the user MUST read before he can be entered into the DATABASE.
  130.  
  131.      USS1 will ask the user to enter one of the phone numbers he entered
  132.      when he logged on.  This is to ensure (somewhat) that it is actualy
  133.      the user and not someone who found his password and logged on as
  134.      Him/Her.
  135.  
  136.      USS1 automatically locates CONFIG.RA which it uses to find USERS.BBS
  137.      and then verify the number the user entered.
  138.  
  139.  
  140.      INFORMATION SYSTEMS SOFTWARE
  141.      USS1 Documentation
  142.      Page 4
  143.  
  144.      USS1 will not allow a user who is already in the DATABASE to be added
  145.      again.  If the User's account has expired and you need to upgrade,
  146.      use the EDITDAT program to Edit him and extended his ACCOUNT. I did
  147.      this to prevent duplicate accounts by the same user.
  148.  
  149.      You can pass one Parameter to USS1 and that is the length of the
  150.      time the subscription is for, ie.....
  151.  
  152.      USS1.EXE 180
  153.  
  154.      This would make the user's subscription for 180 days from the time
  155.      he is entered into the DataBase.  Default is 365 days IF nothing
  156.      is entered on the command line.
  157.  
  158.      USS1 Will change ONE flag setting if you so desire and that is Flag
  159.      A8.  You can Activate it by a second command Line Paramater of ON.
  160.      This will turn OFF Flag A8, ie.....
  161.  
  162.      USS1 365 ON         <- You must include the 1st Param
  163.  
  164.      I set my system up like this:
  165.  
  166.      ALL NEW users Have their A8 Flag Set to ON. In my TopMenu I have a
  167.      Hot Keyed Menu that has the A8 flag set (A hot keyed Menu is a Menu
  168.      that execute Via ^A in the KEY Field of a Menu), this causes them to
  169.      Goto The USS1 Menu, which then executes USS1.EXE 180 ON.  When the
  170.      User COMPLETES the Door FLAG A8 is Set to OFF and he drops to the BBS.
  171.      IF the User decides NOT TO go through the DOOR and decides to HANG-UP,
  172.      Flag A8 is left on and the next time he calls back, he will still end
  173.      up at the USS1.MNU
  174.  
  175.      See USS1.MNU for example
  176.  
  177.      READDAT.EXE
  178.      ───────────
  179.  
  180.      READDAT.EXE is the heart of the system and the program that really
  181.      does all the Work. READDAT first reads the USERDATA.DAT and looks
  182.      for expired accounts.  If it finds one, READDAT will then check
  183.      CONFIG.RA for the location of USERS.BBS and will Set Flag A8 ON
  184.      and lower the security level of all users that fit the criteria.
  185.      Readdat uses TODAYS date and compares it to the users subscription
  186.      length to determine if the account is expired.  READDAT uses 1
  187.      Parameter and that is the security level to drop the USERS to,
  188.      ie..
  189.  
  190.      Readdat 10
  191.  
  192.      will drop the USER to Security level 10
  193.  
  194.      You can use any security level you desire, however if no parameter
  195.      is given it will default to 10.
  196.  
  197.      INFORMATION SYSTEMS SOFTWARE
  198.      USS1 Documentation
  199.      Page 5
  200.  
  201.      EDITDAT.EXE
  202.      ───────────
  203.  
  204.      EDITDAT.EXE is the editor to Edit/Update/Browse and search for TODAYS
  205.      expired accounts in the Database.  You can find a user by his/her name
  206.      or search by partial name.
  207.  
  208.      Main Prompt
  209.  
  210.      Here you can enter a Users Whole Name or Partial Name and EditDat will
  211.      stop and Display the First Occurance of the Search String
  212.  
  213.      While at the Edit Screen you See .....
  214.  
  215.  
  216.      1: STEPHAN HOWARD      <Field 1>
  217.  
  218.       User's Name, this to change the Users Name or Put DELETED in this
  219.       Field to Delete this record at the end of editing.
  220.  
  221.      2: 01/01/91            <Field 2>
  222.  
  223.       Users start Date is the Date the User First entered the Door and
  224.       is used by READDAT to determine the Expiration date based on Field 3.
  225.  
  226.      3: 365                 <Field 3>
  227.  
  228.       User's Subscription Length is the Number of Days from field 1 that
  229.       shows when the user's account expires.  This the expiration Time
  230.       you set up when the user entered USS1 <the default is 365 days>.
  231.  
  232.      4: 01/01/91            <Field 4>
  233.  
  234.       User's expiration Date is the date that the User's account expires.
  235.       READDAT does Not use this field, it is there mainly for a reference
  236.       date for you to see when the account actualy expires.
  237.  
  238.  
  239.       If you change the User's Start Date <Field 1>, EDITDAT will auto-
  240.       matically change the User's Expiration Date <Field 3>.
  241.       If you change the User's Subscription length EDITDAT will automat-
  242.       ically change the User's Expiration Date <Field 3>.
  243.  
  244.      P or p
  245.  
  246.        Page Through the DataBase, ESC will allow you to edit the Current
  247.        Record in the Viewing Window.
  248.  
  249.      A or a
  250.  
  251.        Before adding a user to the DataBase, the user must be in Users.BBS
  252.        or you will not be able to add him.
  253.  
  254.  
  255.      INFORMATION SYSTEMS SOFTWARE
  256.      USS1 Documentation
  257.      Page 6
  258.  
  259.      T or t
  260.  
  261.        Search for TODAYS expired accounts, ESC will allow you to edit the
  262.        current record in the Viewing Window.
  263.  
  264.      N or n
  265.  
  266.        New Search Specification Using whole or Partial Names.
  267.  
  268.      S or s
  269.  
  270.        Save the cuurrent record/Field you are editing. This is done
  271.        automatically whenever you exit the current record by any of
  272.        the other Keys but if you want to change a field then save
  273.        it this option is available.
  274.  
  275.      Q or q
  276.  
  277.       Quit the Program. What happens Next is EditDat will then Search the
  278.       DataBase for anyRecords Mark as DELETED and if found remove them from
  279.       the DataBase.
  280.  
  281.      To Delete an Account you MUST enter DELETED in the Name Field <Field 1>
  282.      of the Users Record you want to delete otherwise when you exit EDITDAT
  283.      and it Searches for deleted records it will be ignored.
  284.  
  285.  
  286.  
  287.                            -= SOME FINAL THOUGHTS =-
  288.  
  289.      Should you have any questions concerning this program and or ideas
  290.      on improvements, I'm reachable in the RA_UTIL Echo & via NetMail at:
  291.  
  292.      FidoNet  - 1:275/3
  293.  
  294.      Thanks.
  295.  
  296.      Stephan Howard
  297.      ISS
  298.  
  299.      INFORMATION SYSTEMS SOFTWARE
  300.      USS1 Documentation
  301.      Appendix A
  302.                              -= SUPPORT SYSTEMS =-
  303.  
  304.      These are the Primary ISS Support Systems and will always have the
  305.      current version of USS1 available for file request using the magic
  306.      name of USS1.
  307.  
  308.      Doc's Place BBS                             The Cold Zone
  309.      Franklin, MA                                Monroe, WI
  310.  
  311.      508-528-7465                                608-328-8202
  312.  
  313.      FidoNet  - 1:322/235                        FidoNet  - 1:11/717
  314.      RBBS-Net - 8:906/201                        RBBS-Net - 8:972/406
  315.              or 8:906/1000
  316.  
  317.      Suffolk News BBS                            Touch of Ireland
  318.      Suffolk, VA                                 Virginia Beach, VA
  319.  
  320.      804 -393-2199                               804-495-4955
  321.  
  322.      FidoNet  - 1:275/326                        FidoNet  - 1:275/3
  323.  
  324.  
  325.      INFORMATION SYSTEMS SOFTWARE
  326.      USS1 Documentation
  327.      Appendix B
  328.                              -= REGISTRATION FORM =-
  329.                                 -----------------
  330.  
  331.                                        USA
  332.  
  333.                   Enclosed is my registration fee for USS1:
  334.  
  335.  
  336.  
  337.           Name: _______________________________________________________
  338.  
  339.  
  340.           Street: _____________________________________________________
  341.  
  342.  
  343.           City: _____________________________State:__________Zip:______
  344.  
  345.  
  346.           Amount $10.00 U.S.   ______Check  ______US Postal Money Order
  347.           (Please make payable to Information Systems Software);
  348.  
  349.           BBS Name as it appears
  350.           in RACONFIG:________________________________________________
  351.  
  352.  
  353.           Sysop Name as it appears
  354.           in RACONFIG:________________________________________________
  355.  
  356.  
  357.           BBS Phone:____________________   Net/Node Number:___________
  358.  
  359.  
  360.           Type of computer____________________________________________
  361.  
  362.  
  363.           Fossil Driver________________   Locked fossil?______________
  364.  
  365.  
  366.           Mail with payment to:   Doris Zagorski  C/O
  367.                                   Information Systems Software
  368.                                   656 Old West Central Street
  369.                                   Franklin, Ma.  02038                                  C/O Stephan Howard
  370.                                   USA
  371.  
  372.           Program Suggestions/Comments________________________________
  373.  
  374.           ____________________________________________________________
  375.  
  376.           ____________________________________________________________
  377.  
  378.           ____________________________________________________________
  379.  
  380.